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Who We Are 

• Kennedy Space Center, Florida 

• Talents 

- Engineers 

- IT 

- Software Development 

• Our Job 

- Administer 

- Improve/Automate processes 

• Not our Job 

- Server Side 



Streamlining Change Management with Business Rules 


PTC" Live 

Global 


WHAT ARE BUSINESS RULES? 

• Persistable Windchill objects 

- Set 

- Rule 

- Link 

• Control the quality of data 

- Don’t let improperly configured data through. 

• Reduce the time to complete tasks 

- Does the validation before the checker/approver even gets the task. 

- Can automatically reroute if there is a fail. 

• Customizable to meet specific needs 

- Check for attributes, state of the object or even states of dependent objects. 
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BUSINESS RULE OBJECTS 

• Sets 
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BUSINESS RULE OBJECTS 

* Sets, Rules 
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BUSINESS RULE OBJECTS 

* Sets, Rules, and Links 
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BUSINESS RULE OBJECTS 

* Sets, Rules, and Links 

* Link to other sets 
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Business Rule Selector 

Rule Validation 

“com.ptc.core.businessRules.validation” 

Description 

CHECKOUT_RULE 

CheckoutRuleValidator 

Validates that objects are not checked out. 

RELEASE_TARGET 

ReleaseTargetValidator Ensures that all “Resulting Objects” are at 

an appropriate state for release and have 
an appropriate change management 
transition specified that is consistent with 
the assigned lifecycle transition rules. 

ATTRIBUTE_RULE 

AttributeRuleValidator Validates that the specified attribute rule 

configuration for an object type is valid. 

BOM_RELEASE_RULE 

BOMReleaseRuleValidator Ensures that all resulting objects are at an 

appropriate state and all their first level 
children are at an appropriate state. 
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CREATING BUSINESS RULES (Traditional Approach) 

* XML files 

- Set. xml 

- Rule.xml* 

- Link.xml* 

- LoadFile.xml 

* Zip the business rule objects. 

- The set, rule and link files 

* Call out the LoadFile.xml 

- Use the LoadFromFile command in a Windchill shell 
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CREATING BUSINESS RULES (Traditional Approach) 

• XML Tips 

- Must follow standardX20.dtd 

• <Windchill>codebase\registry\ixb\dtds\standardX20.dtd\businessRules.dtd 

• Defines the elements and the structure of the XML document 

- Check your spelling! 

</BuisnessRuleLink> </BusinessRuleLink> 

<localID> <localId> 

- White space is preserved 

<key> 

ACME_P ART_ATTRI BUT E_RU L E » <key>ACME_PART_ATTRIBUTE_RULE</key> 

</key> 
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EXAMPLES ATTRIBUTES 

* Requirements 

- WTPart number must begin with an ‘A’ 

- WTPart cage code must be from the set 

• [ACM01 ,ACM02,ACM03,ACM04] 


• To Do 

- Create set.xml file 

- Create rule.xml file 

- Create link.xml file 

- Create load. xml file 

- Execute load from file command 
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CREATING BUSINESS RULES 


<?xml version="l. 0" encoding="UTF-8" ?> 

dDOCTYPE BusinessRuleSet SYSTEM M standandX20.dtd"> 

<BusinessRuleSet> 

<ObjectID> 

<localId>wt . business Rules. BusinessRuleSet :00001</localld> 

</ObjectID> 

<objectContainenPath>/wt . inf . container. OngContainer=ACME</objectContainenPath> 
< key >ACME_PRE_RE LEASE II</key> 

<name>ACME_ReleaseRuleSet</name> 

<description>To test basic Attribute RuleSet Validation</description> 
<enabled>true</enabled> 

<overridable>true</overridable> 
cupdatelf Exist s>t rue</updatelf Exist s> 

< /Bu sines s RuleSet > 


(wt.businessRules. BusinessRuleSet) 

• Identification 

• OID 

• Key 

• Name 

• Where 

• Container Path 

• Other 

• Description 

• Enabled 

• Overridable 
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CREATING BUSINESS RULES 


<?xml version="l. 0" encoding="UTF-8" ?> 
dDOCTYPE BusinessRule SYSTEM M standardX20.dtd"> 

<BusinessRule> 

<ObjectIDxlocalId>wt . business Rules . BusinessRule:000001</localIdx/ObjectID> 
<objectContainerPath>/wt . inf . container. OrgContainer=ACME</objectContainerPath> 
<key>ACME_PART_ATTRIBUTE_RULE</key> 

<selector>ATTRIBUTE_RULE</selector> 

<name>ACME Number Rule</name> 

<description>Number must always begin with an ( A’ </description> 

<enabled>true</enabled> 

cupdatelf Exist s>true</updat elf Exist s> 

<configs> 

<config name= "objectType" vaLue="wt . part .WTPart"x/config> 
cconfig name= "CAGE_CODE " vaLue= " [ACM01jACM02j ACM03j ACM04] "></config> 
<config name= "number" vaLue="BEGINSWITH(A) " ></config> 

</configs> 

</BusinessRule> 


RULE (wt.businessRules.BusinessRule) 

• Configs 

• Name-Value pair 

• Name is the internal name 


\ 
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CREATING BUSINESS RULES 


<?xml version="l. 0" encoding="UTF-8" ?> 

clDOCTYPE BusinessRuleLink SYSTEM M standandX20. dtd"> 

<Bu sines sRuleLink> 

<ObjectID> 

<localId>wt . business Rules. BusinessRuleLink :000001</localld> 
</ObjectID> 

<nuleSet> 

<ObjectRefenence> 

<localId>wt .businessRules .BusinessRuleSet :000001</localld> 
</ObjectReference> 

</ruleSet> 

<nule> 

<ObjectRefenence> 

<localId>wt .businessRules .BusinessRule :000001</localld> 
</ObjectReference> 

</rule> 

< bloc kNumben>l< /bloc kNumber> 

<updatelf Exist s>t nue</updatelf Exist s> 

< /Bu sines sRuleLink> 


LINK (wt.businessRules.BusinessRuleLink) 

• Reference Set 

• Reference Rule 

• State block number 
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LOADING BUSINESS RULES 


LoadRules.xml 

• Call this file from a Windchill shell 

• If any of the xml files are not formatted 
correctly, an error will be thrown and nothing 
will be imported* 


<?xml version="l. 0" encoding="UTF-8" ?> 
clDOCTYPE NmLoader SYSTEM "standardX20.dtd"> 

<NmLoader> 

ccsvExecutelmport handler="M/t. Load. Loadlmport . executelmport" > 

<csvimportFilename>loadFiles/ixbImport/Examples/One/RuleConf iguration_One. zip 
</csvimportFilename> 

</csvExecuteImpont> 

</NmLoader> 


windchill wt.load.LoadFromFile -d <Windchill>\pathTo\LoadRules.xml 
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Windchill Shell Output 

• All objects were imported successfully. 

• Check method server output for successful completion of all loads. 
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LOADING BUSINESS RULES 

Windchill Shell Output 

• All objects were imported successfully. 

• Check method server output for successful completion of all loads. 

Method Server Log Output 

• Unable to create a BusinessRuleLink object without both a ruleSet and a rule 

• All objects were imported successfully 
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LOADING BUSINESS RULES 

Windchill Shell Output 

• All objects were imported successfully. 

• Check method server output for successful completion of all loads. 

Method Server Log Output 

• Unable to create a BusinessRuleLink object without both a ruleSet and a rule 

• All objects were imported successfully 


Key t 

Name 

Context 

Enab ed 

Overrid... 

Ord... Description 

ACME.PRE.RELEASE 

ACME.ReleaseRuleSe: 

Rocket 

Yes 

Yes 

To test basic Attribute Ru eSet Validation 

ffl CHANGEABLE_PRE_RELEASE 

Change Pre-Release Validation 

Site 

Yes 

Yes 

Business Rjle Set jsed before objects are released as part of 
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LOADING BUSINESS RULES 

Windchill Shell Output 

• All objects were imported successfully. 

• Check method server output for successful completion of all loads. 

Method Server Log Output 
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LOADING BUSINESS RULES 

Windchill Shell Output 

• All objects were imported successfully. 

• Check method server output for successful completion of all loads. 


PTC* Live 

Global 



Key t 

Name 

Context 

Enab ed 

Overrid... 

Ord... Description 













|a AC ME_PRE_RE LEASE," 

ACME_ReleaseRuleSe: 

ACME 

Yes 

Yes 

To test bas c Attribute Ru eSet Validation 

1 ACME_PART_ATTRIBUTE_RULE 

ACME Number Rule 

ACME 

Yes 


1 Number must a ways begin with an A' 

a CHANGEABLE.PRE.RELEASE 

Change Pre-Release Validation 

Site 

Yes 

Yes 

Business Rjle Set jsed before objects are released as part o' 
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Configure Workflow 


Default Change Notice Workflow 

• Edit Change Notice Workflow 

• Edit conditional in Resolve Conflicts loop. 


& t— 

Rework Change Notice Task 


Rework 


& 


\ 


Au d it C h a n g e N oti c e .. 


Revisioning Enabled 


+ a 


Resolved 




Synch on CA Complete Rework 


H> O 

OR 


\ Revisioning Disabled 


X7 / 

& 

Audit Change Notice 


Revise 


Complete 


Complete 


& 

Revise Change Notice 


Release Changeables 



& 


AND 


Resolve Release Conflicts 
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Configure Workflow 

Default Change Notice Workflow 

• Change name of set to the newly created set 



Audit Change Notice 
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Configure Workflow 

Release Part 


Product: Rocket 

Type: Part 

Number BD0001 
Name: ACME XI Rocket 

Version: A.4 (Design) 


a Attributes 


Make 


* Assembly Mode: Separable T 

* Source: 

Cage Code: 

Design Authority: 


ITAR Controlled: Undefirec 

<§> Yes 
-No 


Weight: 


10000 



kg 








) 
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Configure Workflow 

Resolve Release Conflicts task 
• Click on View Rule Conflicts 
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Configure Workflow 

Resolve Release Conflicts task 

• Click on View Rule Conflicts 

* View conflicts 
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Actions ▼ | 



Actions ▼ UTask - Change Notice Workflow_00003-Resolve Release Conflicts 


View Rule Conflicts 






B Rule Conflicts Group by Rule 

▼ 


( 2 objects ) 

Actions ▼ 


Find in tree 

▼ A © 

Ru e Name 

Identity t 

Conflicts 


Q ACME Number Rule (1) 

4a 

■ B00001, ACM E XI Rocket. A.4 (Desi gn) 

i) Error : Cage Code is not in the discrete set [ACM01, ACM02, ACM03, ACM04]. 
Error : Number does not start with A. 



L 


Mill npiip MAPMMiipii m I.!'*! HJ* "U'AC IMP. UUP!. IHJI MM. 'ill' I"? UJi'PMl IC'WW LU"MJ W'l 'l!-. 

• f I rlf V run nn r-irn / ~nrrl rr -hniiin y n n run ’•nn fm rj rritnrh rpf ilt<- 






J"~ 
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CREATING BUSINESS RULES - (Custom Approach) 

• No more XML files 

- No longer have to be familiar with XML syntax 

- Cuts down on human error 

- Saves time 

• No more local actions 

- Some administrators do not have access 

• Windchill API 

- Utility Class 

• Query, Create, Modify and Delete 

- JSP Web based GUI 


• Fast 

• Instant gratification 


\ 
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CREATING BUSINESS RULES - (Custom Approach) 
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CREATING BUSINESS RULES - (Custom Approach) 
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ROCKET_CONFIG 

ROCKET_RELEASE 

ACME_PRE_RELEASE 


ACME PRE RELEASE II 
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CREATING BUSINESS RULES - (Custom Approach) 
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CREATING BUSINESS RULES - (Custom Approach) 

• Requirements 

- Required Atttributes must be set 

- Number must start with an ‘A’ 

- Number must end with a ‘-PT’ 

- Number cannot contain special characters 

- Part cannot be from a vendor 
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EXAMPLES BOM RELEASE 
• Create Set 
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EXAMPLES BOM RELEASE 
• Create Set 
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EXAMPLES BOM RELEASE 

• Create Set 

• Create Rule 
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EXAMPLES BOM RELEASE 

• Create Set 

• Create Rule 
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EXAMPLES BOM RELEASE 

• Create Set 

• Create Rule 
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EXAMPLES BOM RELEASE 

• Create Set 

• Create Rule 

• Add configs 

- targetState 

- collectionComponentID 

- validDependentState 
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EXAMPLES BOM RELEASE 

• Create Set 

• Create Rule 

• Add configs 

- targetState 

- collectionComponentID 

- validDependentState 
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EXAMPLES BOM RELEASE 

• Release End Item 

- Structure has items In-Work 


* ACME XI Rocket 

In Work 

0SRB 

Released 

* 3 Stage 1 

Released 

3 LF Engine 1 

Released 

3 LF Tank 1 

Released 

* 3 Stage 2 

Released 

3 LF Engine 2 

Released 

3 LF Tank 2 

Released 

* 3 Stage 3 

In Work 

3 Command Module 

Released 

3 Escape Tower 

In Work 

3 Fairing 

Released 

3 LF Engine 3 

Released 

3 LF Tank 3 

Released 

3 Service Module 

Released 
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EXAMPLES BOM RELEASE 
• View Conflicts as usual 
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View Rule Conflicts 


S Rule Conflicts 

Group by Rule 


Actions ▼ 


Find in tree 

Ru-e Narre 

Identity t 

Conflicts 


□ Validate Children States (1) 


AOOOOl, ACME XI Rocket, A.5 (Design) i ) Error : The ife eye e state of ore or more associated objects is not va id for releas ng the target object. Valid ife eye e states are: Released. 

( 
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References 

• Windchill Help Center 

- http://support.ptc.com/cs/help/windchill_hc/wc101_hc/index.jspx?id=BusRules&action=show 

• Windchill eSupport 

• Windchilll Javadocs 

• W3Schools - XML Syntax 

- http://www.w3schools.com/xml/xml_syntax.asp 
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• Your feedback is valuable 

• Don’t miss out on the chance to provide your feedback 

• Gain a chance to win an instant prize! 

• Complete your session evaluation now 
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